<html xmlns="https://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta http-equiv="Content-Language" content="zh-CN" />
<link href="../style/css/manual-zip.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
<link href="../style/css/manual-zip-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
<title>configure - 配置源代码树 － Apache 2.2 中文手册 [金步国]</title>
<script> var _hmt = _hmt || []; (function() { var hm = document.createElement("script"); hm.src = "https://hm.baidu.com/hm.js?d286c55b63a3c54a1e43d10d4c203e75"; var s = document.getElementsByTagName("script")[0]; s.parentNode.insertBefore(hm, s); })(); </script>
</head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/index.html">模块索引</a> | <a href="../mod/directives.html">指令索引</a> | <a href="../faq/index.html">常见问题</a> | <a href="../glossary.html">词汇表</a> | <a href="../sitemap.html">站点导航</a></p><p class="apache">Apache HTTP Server 版本2.2</p><img alt="" src="../images/feather.gif" /></div>
<div class="up"><a href="index.html"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
<div id="path"><a href="https://www.apache.org/">Apache</a> &gt; <a href="https://httpd.apache.org/">HTTP Server</a> &gt; <a href="https://httpd.apache.org/docs/">文档</a> &gt; <a href="../index.html">版本2.2</a> &gt; <a href="index.html">支持程序</a></div>

<div id="translation-info">　　 <a href="../translator_announcement.html#thanks">致谢</a> | 本篇译者：<a href="../../../index.html">金步国</a>(<a href="../../../index.html">作品集</a>) | 本页最后更新：2006年10月29日</div>
<div id="page-content">
<div id="preamble"><h1>configure - 配置源代码树</h1>


    <p><code>configure</code>脚本配置Apache的源代码树并且将其安装到指定的平台上。丰富的选项允许你根据自己的特定状况和特定需求对Apache进行定制。
</p>

    <p>这个脚本位于源代码树的根目录下，并且只能用于类Unix操作系统。要了解其他平台的信息，参见：<a href="../platform/index.html">针对特定平台的说明</a>文档。</p>
</div>
	<div class="top"><a href="configure.html#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="synopsis" id="synopsis">语法</a></h2>
    <p>你必须在源代码树的根目录下调用<code>configure</code>脚本，语法如下：</p>

    <p><code><strong>./configure</strong> [<var>OPTION</var>]...
    [<var>VAR</var>=<var>VALUE</var>]...</code></p>

    <p>若要指定环境变量(比如：<code>CC</code>, <code>CFLAGS</code> ...)，请使用 <code><var>VAR</var>=<var>VALUE</var></code> 的格式。<a href="configure.html#env">下面</a>有一些有用的环境变量说明。</p>
</div>
<div class="top"><a href="configure.html#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">选项</a></h2>
  <ul>
    <li><a href="configure.html#configurationoptions">配置选项</a></li>
    <li><a href="configure.html#installationdirectories">安装目录</a></li>
    <li><a href="configure.html#systemtypes">系统类型</a></li>
    <li><a href="configure.html#modoptions">模块选项</a></li>
    <li><a href="configure.html#otheroptfeat">杂项选项</a></li>
    <li><a href="configure.html#aproptfeat">传递给<code>apr-config</code>脚本的选项</a></li>
    <li><a href="configure.html#packages">特殊程序包选项</a></li>
    <li><a href="configure.html#supportopt">支持程序选项</a></li>
  </ul>

  <h3><a name="configurationoptions" id="configurationoptions">配置选项</a></h3>

    <p>下列选项会影响<code>configure</code>脚本自身的行为。方括号"[]"内是默认值。</p>

    <dl>
      <dt><code>-C</code></dt>
      <dt><code>--config-cache</code></dt>
      <dd>等价于 <code>--cache-file=config.cache</code> </dd>

      <dt><code>--cache-file=<var>FILE</var></code></dt>
      <dd>在<var>FILE</var>文件中缓存测试结果(默认禁用)。</dd>

      <dt><code>-h</code></dt>
      <dt><code>--help[=short|recursive]</code></dt>
      <dd>显示帮助信息然后退出。使用<code>short</code>参数将只显示正在运行的当前脚本的选项，而不能列出适用于Apache配置脚本所运行的外部配置脚本的选项。使用<code>recursive</code>参数将显示所有程序包的简短描述。</dd>

      <dt><code>-n</code></dt>
      <dt><code>--no-create</code></dt>
      <dd><code>configure</code>脚本运行结束后不输出结果文件，常用于正式编译前的测试。</dd>

      <dt><code>-q</code></dt>
      <dt><code>--quiet</code></dt>
      <dd>不显示脚本工作期间输出的"<code>checking ...</code>"消息。</dd>

      <dt><code>--srcdir=<var>DIR</var></code></dt>
      <dd>指定源代码所在目录<var>DIR</var> 。[configure脚本所在目录或父目录]</dd>

      <dt><code>--silent</code></dt>
      <dd>等价于 <code>--quiet</code></dd>

      <dt>-V</dt>
      <dt>--version</dt>
      <dd>显示版权信息后退出。</dd>
    </dl>


  <h3><a name="installationdirectories" id="installationdirectories">安装目录</a></h3>

    <p>这些选项控制着安装目录的结构。安装目录的结构取决于所选择的布局。方括号"[]"内是默认值。</p>

    <dl>
      <dt><code>--prefix=<var>PREFIX</var></code></dt>
      <dd>体系无关文件的顶级安装目录<var>PREFIX</var> ，也就Apache的安装目录。[<code>/usr/local/apache2</code>]</dd>

      <dt><code>--exec-prefix=<var>EPREFIX</var></code></dt>
      <dd>体系相关文件的顶级安装目录<var>EPREFIX</var> ，把体系相关的文件安装到不同的位置可以方便地在不同主机之间共享体系相关的文件。[<var>PREFIX</var>]</dd>
    </dl>

    <p>默认情况下，<code>make install</code> 将会把所有文件分别安装到<code>/usr/local/apache2/bin</code> , <code>/usr/local/apache2/lib</code> 目录下。可以用 <code>--prefix</code> 指定一个不同于<code>/usr/local/apache2</code>的安装前缀，比如：<code>--prefix=$HOME</code> 。</p>

    <h4><a name="layout" id="layout">定义一个目录布局</a></h4>
      <dl>
        <dt><code>--enable-layout=<var>LAYOUT</var></code></dt>
        <dd>使用名为<var>LAYOUT</var>的布局配置所有源代码和编译脚本。这样就允许你在安装Apache时分别指定不同文件的安装位置。<code><a href="config.layout.txt">config.layout</a></code>文件中包含了默认布局的示例，你可以根据它创建你自己的布局。这个文件中的不同布局使用<code>&lt;Layout FOO&gt;...&lt;/Layout&gt;</code>段进行分组，其中的<code>FOO</code>就是布局名。默认的布局是<code>Apache</code> 。</dd>
      </dl>


    <h4><a name="directoryfinetuning" id="directoryfinetuning">安装目录微调</a></h4>

      <p>可以使用下面的选项微调安装目录。下列选项的默认值由<code>autoconf</code>自动设置并在方括号"[]"内说明。</p>

      <dl>

        <dt><code>--bindir=<var>DIR</var></code></dt>
        <dd>用户可执行目录<var>DIR</var> 。用于存放对网站管理员很有帮助的<code class="program"><a href="htpasswd.html">htpasswd</a></code>, <code class="program"><a href="dbmmanage.html">dbmmanage</a></code>之类的支持程序。<br />[<code><var>EPREFIX</var>/bin</code>]</dd>

        <dt><code>--datadir=<var>DIR</var></code></dt>
        <dd>Web服务器只读的体系无关数据目录<var>DIR</var> 。虽然<code>autoconf</code>提供了该选项，但Apache并未使用它。<br />[<code><var>PREFIX</var>/share</code>]</dd>

        <dt><code>--includedir=<var>DIR</var></code></dt>
        <dd>Apache的C头文件目录<var>DIR</var> 。<br />[<code><var>EPREFIX</var>/include</code>]</dd>

        <dt><code>--infodir=<var>DIR</var></code></dt>
        <dd>信息文档目录<var>DIR</var> 。虽然<code>autoconf</code>提供了该选项，但Apache并未使用它。<br />[<code><var>PREFIX</var>/info</code>]</dd>

        <dt><code>--libdir=<var>DIR</var></code></dt>
        <dd>对象代码库目录<var>DIR</var> 。<br />[<code><var>EPREFIX</var>/lib</code>]</dd>

        <dt><code>--libexecdir=<var>DIR</var></code></dt>
        <dd>程序可执行目录<var>DIR</var> ，也就是动态加载模块目录。<br />[<code><var>EPREFIX</var>/libexec</code>]</dd>

        <dt><code>--localstatedir=<var>DIR</var></code></dt>
        <dd>可写的单一机器数据目录<var>DIR</var> 。虽然<code>autoconf</code>提供了该选项，但Apache并未使用它。<br />[<code><var>PREFIX</var>/var</code>]</dd>

        <dt><code>--mandir=<var>DIR</var></code></dt>
        <dd>手册文档目录<var>DIR</var> 。<br />[<code><var>EPREFIX</var>/man</code>]</dd>

        <dt><code>--oldincludedir=<var>DIR</var></code></dt>
        <dd>非gcc的C头文件目录<var>DIR</var> 。虽然<code>autoconf</code>提供了该选项，但Apache并未使用它。<br />[<code>/usr/include</code>]</dd>

        <dt><code>--sbindir=<var>DIR</var></code></dt>
        <dd>系统管理员可执行目录<var>DIR</var> ，用于存放运行HTTP服务器所必须的<code class="program"><a href="httpd.html">httpd</a></code>, <code class="program"><a href="apachectl.html">apachectl</a></code>, <code class="program"><a href="suexec.html">suexec</a></code>之类的服务程序。<br />[<code><var>EPREFIX</var>/sbin</code>]</dd>

        <dt><code>--sharedstatedir=<var>DIR</var></code></dt>
        <dd>可写的体系无关数据目录<var>DIR</var> 。虽然<code>autoconf</code>提供了该选项，但Apache并未使用它。<br />[<code><var>PREFIX</var>/com</code>]</dd>

        <dt><code>--sysconfdir=<var>DIR</var></code></dt>
        <dd>只读的单一机器数据目录<var>DIR</var> ，用于存放<code>httpd.conf</code>和<code>mime.types</code>之类的服务器配置文件。<br />[<code><var>PREFIX</var>/etc</code>]</dd>
      </dl>



  <h3><a name="systemtypes" id="systemtypes">系统类型</a></h3>

    <p>这些选项用于交叉编译在其他平台上运行的Apache HTTP服务器。在同一平台上编译和运行Apache HTTP服务器通常不需要使用这些选项，脚本会自动检测并设置。方括号"[]"内是默认值。</p>

    <dl>
      <dt><code>--build=<var>BUILD</var></code></dt>
      <dd>指定编译工具所在系统的系统类型<var>BUILD</var> 。<br />[<code>config.guess</code>脚本的检测结果]</dd>

      <dt><code>--host=<var>HOST</var></code></dt>
      <dd>指定Apache HTTP服务器将要运行的目标系统类型<var>HOST</var> 。<br />[<var>BUILD</var>]</dd>

      <dt><code>--target=<var>TARGET</var></code></dt>
      <dd>configure for building compilers for <var>TARGET</var>类型的系统。虽然<code>autoconf</code>提供了该选项，但Apache并未使用它。<br />[<var>HOST</var>]</dd>
    </dl>


  <h3><a name="modoptions" id="modoptions">模块选项</a></h3>

    <p>有两种使用模块的方法：一是静态连接进核心，二是作为DSO模块动态加载；如果编译中包含任何DSO模块，则mod_so会被自动包含进核心。如果希望核心能够装载DSO，但不实际编译任何DSO模块，则需明确指定"--enable-so=static"。</p>

    <h4><a name="generaloptfeat" id="generaloptfeat">一般语法</a></h4>
      <p>一般情况下你可以使用如下语法启用或者禁用某个模块：</p>

      <dl>

        <dt><code>--disable-<var>MODULE</var></code></dt>
        <dd>禁用<var>MODULE</var>模块(仅用于基本模块)</dd>

        <dt><code>--enable-<var>MODULE</var>=shared</code></dt>
        <dd>将<var>MODULE</var>编译为DSO(可用于所有模块)</dd>

        <dt><code>--enable-<var>MODULE</var>=static</code></dt>
        <dd>将<var>MODULE</var>静态连接进核心(仅用于扩展和实验模块)</dd>

		<dt><code>--enable-mods-shared=<var>MODULE-LIST</var></code></dt>
        <dd>将<var>MODULE-LIST</var>中的所有模块都编译成DSO(可用于所有模块)</dd>

        <dt><code>--enable-modules=<var>MODULE-LIST</var></code></dt>
        <dd>将<var>MODULE-LIST</var>静态连接进核心(可用于所有模块)</dd>

		<p></p>
          <p>上述 <var>MODULE-LIST</var> 可以是：<br />
          (1)用引号界定并且用空格分隔的模块名列表</p>
          <div class="example"><p><code>
            --enable-mods-shared='headers rewrite dav'
          </code></p></div>
          <p>(2)"<code>most</code>"(大多数模块［遇见错误模块时忽略该模块而不中断配置过程］)<br />(3)"<code>all</code>"(所有模块［遇见错误模块时中断配置过程并报错］)</p>
          <div class="example"><p><code>
            --enable-mods-shared=most
          </code></p></div>

      </dl>

      <div class="note"><h3>注意</h3>
        <code>configure</code>将忽略<var>MODULE</var>和<var>MODULE-LIST</var>中的拼写错误，注意仔细拼写。用于<var>MODULE</var>和<var>MODULE-LIST</var>中的名称是"<code>mod_<var>NAME</var></code>"中去掉"<code>mod_</code>"并将剩余部分中的下划线"<code>_</code>"替换为连字符"<code>-</code>"以后的结果，比如"<code>mod_log_config</code>"模块应当表示为"<var>log-config</var>"。
      </div>

    <h4><a name="module-list" id="module-list">模块列表</a></h4>
      <p>基本(B)模块默认包含，必须明确禁用；扩展(E)/实验(X)模块默认不包含，必须明确启用。</p>
<table border="1" cellpadding="0" cellspacing="0" bordercolor="#AAAAAA">
<tr><td>模块名称</td><td>状态</td><td>简要描述</td></tr>
<tr><td><code class="module"><a href="../mod/mod_actions.html">mod_actions</a></code></td><td>(B)</td><td>根据特定的媒体类型或请求方法，激活特定的CGI脚本</td></tr>
<tr><td><code class="module"><a href="../mod/mod_alias.html">mod_alias</a></code></td><td>(B)</td><td>提供从文件系统的不同部分到文档树的映射和URL重定向</td></tr>
<tr><td><code class="module"><a href="../mod/mod_asis.html">mod_asis</a></code></td><td>(B)</td><td>发送自己包含HTTP头内容的文件</td></tr>
<tr><td><code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code></td><td>(B)</td><td>使用基本认证</td></tr>
<tr><td><code class="module"><a href="../mod/mod_authn_default.html">mod_authn_default</a></code></td><td>(B)</td><td>在未正确配置认证模块的情况下简单拒绝一切认证信息</td></tr>
<tr><td><code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code></td><td>(B)</td><td>使用纯文本文件为认证提供支持</td></tr>
<tr><td><code class="module"><a href="../mod/mod_authz_default.html">mod_authz_default</a></code></td><td>(B)</td><td>在未正确配置授权支持模块的情况下简单拒绝一切授权请求</td></tr>
<tr><td><code class="module"><a href="../mod/mod_authz_groupfile.html">mod_authz_groupfile</a></code></td><td>(B)</td><td>使用纯文本文件为组提供授权支持</td></tr>
<tr><td><code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code></td><td>(B)</td><td>供基于主机名、IP地址、请求特征的访问控制</td></tr>
<tr><td><code class="module"><a href="../mod/mod_authz_user.html">mod_authz_user</a></code></td><td>(B)</td><td>基于每个用户提供授权支持</td></tr>
<tr><td><code class="module"><a href="../mod/mod_autoindex.html">mod_autoindex</a></code></td><td>(B)</td><td>自动对目录中的内容生成列表，类似于"ls"或"dir"命令</td></tr>
<tr><td><code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code></td><td>(B)</td><td>在非线程型MPM(<code class="module"><a href="../mod/prefork.html">prefork</a></code>)上提供对CGI脚本执行的支持</td></tr>
<tr><td><code class="module"><a href="../mod/mod_cgid.html">mod_cgid</a></code></td><td>(B)</td><td>在线程型MPM(<code class="module"><a href="../mod/worker.html">worker</a></code>)上用一个外部CGI守护进程执行CGI脚本</td></tr>
<tr><td><code class="module"><a href="../mod/mod_dir.html">mod_dir</a></code></td><td>(B)</td><td>指定目录索引文件以及为目录提供"尾斜杠"重定向</td></tr>
<tr><td><code class="module"><a href="../mod/mod_env.html">mod_env</a></code></td><td>(B)</td><td>允许Apache修改或清除传送到CGI脚本和SSI页面的环境变量</td></tr>
<tr><td><code class="module"><a href="../mod/mod_filter.html">mod_filter</a></code></td><td>(B)</td><td>根据上下文实际情况对输出过滤器进行动态配置</td></tr>
<tr><td><code class="module"><a href="../mod/mod_imagemap.html">mod_imagemap</a></code></td><td>(B)</td><td>处理服务器端图像映射</td></tr>
<tr><td><code class="module"><a href="../mod/mod_include.html">mod_include</a></code></td><td>(B)</td><td>实现服务端包含文档(SSI)处理</td></tr>
<tr><td><code class="module"><a href="../mod/mod_isapi.html">mod_isapi</a></code></td><td>(B)</td><td>仅限于在Windows平台上实现ISAPI扩展</td></tr>
<tr><td><code class="module"><a href="../mod/mod_log_config.html">mod_log_config</a></code></td><td>(B)</td><td>允许记录日志和定制日志文件格式</td></tr>
<tr><td><code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code></td><td>(B)</td><td>根据文件扩展名决定应答的行为(处理器/过滤器)和内容(MIME类型/语言/字符集/编码)</td></tr>
<tr><td><code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code></td><td>(B)</td><td>提供<a href="../content-negotiation.html">内容协商</a>支持</td></tr>
<tr><td><code class="module"><a href="../mod/mod_nw_ssl.html">mod_nw_ssl</a></code></td><td>(B)</td><td>仅限于在NetWare平台上实现SSL加密支持</td></tr>
<tr><td><code class="module"><a href="../mod/mod_setenvif.html">mod_setenvif</a></code></td><td>(B)</td><td>根据客户端请求头字段设置环境变量</td></tr>
<tr><td><code class="module"><a href="../mod/mod_status.html">mod_status</a></code></td><td>(B)</td><td>生成描述服务器状态的Web页面</td></tr>
<tr><td><code class="module"><a href="../mod/mod_userdir.html">mod_userdir</a></code></td><td>(B)</td><td>允许用户从自己的主目录中提供页面(使用"/~username")</td></tr>
<tr><td><code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code></td><td>(X)</td><td>使用MD5摘要认证(更安全，但是只有最新的浏览器才支持)</td></tr>
<tr><td><code class="module"><a href="../mod/mod_authn_alias.html">mod_authn_alias</a></code></td><td>(E)</td><td>基于实际认证支持者创建扩展的认证支持者，并为它起一个别名以便于引用</td></tr>
<tr><td><code class="module"><a href="../mod/mod_authn_anon.html">mod_authn_anon</a></code></td><td>(E)</td><td>提供匿名用户认证支持</td></tr>
<tr><td><code class="module"><a href="../mod/mod_authn_dbd.html">mod_authn_dbd</a></code></td><td>(E)</td><td>使用SQL数据库为认证提供支持</td></tr>
<tr><td><code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code></td><td>(E)</td><td>使用DBM数据库为认证提供支持</td></tr>
<tr><td><code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code></td><td>(E)</td><td>允许使用一个LDAP目录存储用户名和密码数据库来执行基本认证和授权</td></tr>
<tr><td><code class="module"><a href="../mod/mod_authz_dbm.html">mod_authz_dbm</a></code></td><td>(E)</td><td>使用DBM数据库文件为组提供授权支持</td></tr>
<tr><td><code class="module"><a href="../mod/mod_authz_owner.html">mod_authz_owner</a></code></td><td>(E)</td><td>基于文件的所有者进行授权</td></tr>
<tr><td><code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code></td><td>(E)</td><td>基于URI键的内容动态缓冲(内存或磁盘)</td></tr>
<tr><td><code class="module"><a href="../mod/mod_cern_meta.html">mod_cern_meta</a></code></td><td>(E)</td><td>允许Apache使用CERN httpd元文件，从而可以在发送文件时对头进行修改</td></tr>
<tr><td><code class="module"><a href="../mod/mod_charset_lite.html">mod_charset_lite</a></code></td><td>(X)</td><td>允许对页面进行字符集转换</td></tr>
<tr><td><code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code></td><td>(E)</td><td>允许Apache提供<a href="http://www.webdav.org/">DAV</a>协议支持</td></tr>
<tr><td><code class="module"><a href="../mod/mod_dav_fs.html">mod_dav_fs</a></code></td><td>(E)</td><td>为<code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code>访问服务器上的文件系统提供支持</td></tr>
<tr><td><code class="module"><a href="../mod/mod_dav_lock.html">mod_dav_lock</a></code></td><td>(E)</td><td>为<code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code>锁定服务器上的文件提供支持</td></tr>
<tr><td><code class="module"><a href="../mod/mod_dbd.html">mod_dbd</a></code></td><td>(E)</td><td>管理SQL数据库连接，为需要数据库功能的模块提供支持</td></tr>
<tr><td><code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code></td><td>(E)</td><td>压缩发送给客户端的内容</td></tr>
<tr><td><code class="module"><a href="../mod/mod_disk_cache.html">mod_disk_cache</a></code></td><td>(E)</td><td>基于磁盘的缓冲管理器</td></tr>
<tr><td><code class="module"><a href="../mod/mod_dumpio.html">mod_dumpio</a></code></td><td>(E)</td><td>将所有I/O操作转储到错误日志中</td></tr>
<tr><td><code class="module"><a href="../mod/mod_echo.html">mod_echo</a></code></td><td>(X)</td><td>一个很简单的协议演示模块</td></tr>
<tr><td><code class="module"><a href="../mod/mod_example.html">mod_example</a></code></td><td>(X)</td><td>一个很简单的Apache模块API演示模块</td></tr>
<tr><td><code class="module"><a href="../mod/mod_expires.html">mod_expires</a></code></td><td>(E)</td><td>允许通过配置文件控制HTTP的"<code>Expires:</code>"和"<code>Cache-Control:</code>"头内容</td></tr>
<tr><td><code class="module"><a href="../mod/mod_ext_filter.html">mod_ext_filter</a></code></td><td>(E)</td><td>使用外部程序作为过滤器</td></tr>
<tr><td><code class="module"><a href="../mod/mod_file_cache.html">mod_file_cache</a></code></td><td>(X)</td><td>提供文件描述符缓存支持，从而提高Apache性能</td></tr>
<tr><td><code class="module"><a href="../mod/mod_headers.html">mod_headers</a></code></td><td>(E)</td><td>允许通过配置文件控制任意的HTTP请求和应答头信息</td></tr>
<tr><td><code class="module"><a href="../mod/mod_ident.html">mod_ident</a></code></td><td>(E)</td><td>实现RFC1413规定的ident查找</td></tr>
<tr><td><code class="module"><a href="../mod/mod_info.html">mod_info</a></code></td><td>(E)</td><td>生成Apache配置情况的Web页面</td></tr>
<tr><td><code class="module"><a href="../mod/mod_ldap.html">mod_ldap</a></code></td><td>(E)</td><td>为其它LDAP模块提供LDAP连接池和结果缓冲服务</td></tr>
<tr><td><code class="module"><a href="../mod/mod_log_forensic.html">mod_log_forensic</a></code></td><td>(E)</td><td>实现"对比日志"，即在请求被处理之前和处理完成之后进行两次记录</td></tr>
<tr><td><code class="module"><a href="../mod/mod_logio.html">mod_logio</a></code></td><td>(E)</td><td>对每个请求的输入/输出字节数以及HTTP头进行日志记录</td></tr>
<tr><td><code class="module"><a href="../mod/mod_mem_cache.html">mod_mem_cache</a></code></td><td>(E)</td><td>基于内存的缓冲管理器</td></tr>
<tr><td><code class="module"><a href="../mod/mod_mime_magic.html">mod_mime_magic</a></code></td><td>(E)</td><td>通过读取部分文件内容自动猜测文件的MIME类型</td></tr>
<tr><td><code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code></td><td>(E)</td><td>提供HTTP/1.1的代理/网关功能支持</td></tr>
<tr><td><code class="module"><a href="../mod/mod_proxy_ajp.html">mod_proxy_ajp</a></code></td><td>(E)</td><td><code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>的扩展，提供Apache JServ Protocol支持</td></tr>
<tr><td><code class="module"><a href="../mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code></td><td>(E)</td><td><code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>的扩展，提供负载平衡支持</td></tr>
<tr><td><code class="module"><a href="../mod/mod_proxy_connect.html">mod_proxy_connect</a></code></td><td>(E)</td><td><code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>的扩展，提供对处理HTTP <code>CONNECT</code>方法的支持</td></tr>
<tr><td><code class="module"><a href="../mod/mod_proxy_ftp.html">mod_proxy_ftp</a></code></td><td>(E)</td><td><code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>的FTP支持模块</td></tr>
<tr><td><code class="module"><a href="../mod/mod_proxy_http.html">mod_proxy_http</a></code></td><td>(E)</td><td><code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>的HTTP支持模块</td></tr>
<tr><td><code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code></td><td>(E)</td><td>一个基于一定规则的实时重写URL请求的引擎</td></tr>
<tr><td><code class="module"><a href="../mod/mod_so.html">mod_so</a></code></td><td>(E)</td><td>允许运行时加载DSO模块</td></tr>
<tr><td><code class="module"><a href="../mod/mod_speling.html">mod_speling</a></code></td><td>(E)</td><td>自动纠正URL中的拼写错误</td></tr>
<tr><td><code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code></td><td>(E)</td><td>使用安全套接字层(SSL)和传输层安全(TLS)协议实现高强度加密传输</td></tr>
<tr><td><code class="module"><a href="../mod/mod_suexec.html">mod_suexec</a></code></td><td>(E)</td><td><a href="configure.html#suexec">使用与调用web服务器的用户不同的用户身份来运行CGI和SSI程序</a></td></tr>
<tr><td><code class="module"><a href="../mod/mod_unique_id.html">mod_unique_id</a></code></td><td>(E)</td><td>为每个请求生成唯一的标识以便跟踪</td></tr>
<tr><td><code class="module"><a href="../mod/mod_usertrack.html">mod_usertrack</a></code></td><td>(E)</td><td>使用Session跟踪用户(会发送很多Cookie)，以记录用户的点击流</td></tr>
<tr><td><code class="module"><a href="../mod/mod_version.html">mod_version</a></code></td><td>(E)</td><td>提供基于版本的配置段支持</td></tr>
<tr><td><code class="module"><a href="../mod/mod_vhost_alias.html">mod_vhost_alias</a></code></td><td>(E)</td><td>提供大批量虚拟主机的动态配置支持</td></tr>
</table>

<h4><a name="mpm-modules" id="mpm-modules">多路处理模块(MPM)</a></h4>
<p>必须有而且只能有一个<a href="../mpm.html">MPM</a>被静态包含进核心，你可以使用下面的配置选项进行选择：</p>
	<dl>
        <dt><code>--with-mpm=MPM</code></dt>
        <dd>其中，<code>MPM</code>是你想要使用的多路处理模块的名字。如果你不使用这个选项，那么将会使用对应于各平台的<a href="../mpm.html#defaults">默认MPM</a>，可选的MPM如下：<code class="module"><a href="../mod/beos.html">beos</a></code>, <code class="module"><a href="../mod/mpmt_os2.html">mpmt_os2</a></code>, <code class="module"><a href="../mod/prefork.html">prefork</a></code>, <code class="module"><a href="../mod/worker.html">worker</a></code></dd>
    </dl>


      <h4><a name="third-party-modules" id="third-party-modules">第三方模块</a></h4>
      <p>有至少两种方法可以添加第三方模块，最简单的方法是作为配置参数提供，语法如下：</p>
      <dl>
        <dt><code>--with-module=<var>module-type</var>:<var>module-file</var>[, <var>module-type</var>:<var>module-file</var>]</code></dt>
        <dd><p><code><var>module-file</var></code>是模块的源代码文件名，该文件必须位于Apahe源代码目录树的"<code>modules/<var>module-type</var></code>"目录下，如果<code>configure</code>没有在那里找到<var>module-file</var> ，则将它看作一个绝对路径名并尝试将其复制到"<code>modules/<var>module-type</var></code>"目录中，如果"<code>modules/<var>module-type</var></code>"目录不存在，<code>configure</code>将新建一个"<code>modules/<var>module-type</var></code>"目录并在其中放置一个标准的<code>Makefile.in</code>文件。这种方法有两个明显的缺陷：</p>
		<ol>
          <li>模块的源代码必须是单一文件</li>
          <li>模块只能静态连接进核心，而不能作为DSO模块</li>
		</ol>
		<p></p>
	<p>所以一般并不使用此方法，而是使用<span class="note"><code class="program"><a href="apxs.html">apxs</a></code></span>(Apache扩展工具)来添加第三方模块支持。</p>
          </dd>
	  </dl>

    <h3><a name="otheroptfeat" id="otheroptfeat">杂项选项</a></h3>
      <dl>
        <dt><code>--enable-http</code></dt>
        <dd>启用HTTP协议处理支持</dd>

        <dt><code>--enable-v4-mapped</code></dt>
        <dd>使用相同的套接字同时处理IPv4和IPv6的连接，也就是启用地址映射。在FreeBSD、NetBSD、OpenBSD以外的平台上是默认值。</dd>

        <dt><code>--disable-v4-mapped</code></dt>
        <dd>使用不同的套接字分别处理IPv4和IPv6的连接，也就是禁用地址映射。在FreeBSD、NetBSD、OpenBSD上是默认值。</dd>

        <dt><code>--enable-distcache</code></dt>
        <dd>在<code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code>中启用distcache支持</dd>

        <dt><code>--enable-maintainer-mode</code></dt>
        <dd>使用所有警告和调试符号编译源代码，请勿用于正式服务器，它会影响性能。</dd>

        <dt><code>--enable-exception-hook</code></dt>
        <dd>允许在子进程崩溃以后启用一个钩子来运行异常处理程序。参见<code class="directive"><a href="../mod/mpm_common.html#EnableExceptionHook">EnableExceptionHook</a></code>指令</dd>

        <dt><code>--enable-pie</code></dt>
        <dd>将<code class="program"><a href="httpd.html">httpd</a></code>编译为位置独立的(Position Independent)可执行程序</dd>

        <dt><code>--with-port=<var>PORT</var></code></dt>
        <dd>设定<code class="program"><a href="httpd.html">httpd</a></code>的默认的监听端口[默认为：<var>80</var>]，该值仅在生成默认配置文件<code>httpd.conf</code>时使用。</dd>

        <dt><code>--with-program-name=<var>NAME</var></code></dt>
        <dd>指定可执行程序的名字[默认为：<code>httpd</code>]，若使用此选项则默认配置文件的名字将同时变成"<var>NAME</var>.conf"。</dd>
      </dl>

  <h3><a name="aproptfeat" id="aproptfeat">传递给<code>apr-config</code>脚本的选项</a></h3>
  <p>译者注：<em>下述选项并未出现在官方手册中，译者不保证其真实性，仅供有兴趣的玩家参考。</em></p>
    <dl>
      <dt><code>--enable-nonportable-atomics</code></dt>
      <dd>若只打算在486以上的CPU上运行Apache ，那么使用该选项可以启用更加高效的基于互斥执行的<a href="../misc/perf-tuning.html#atomics">原子操作</a>。</dd>
      <dt><code>--disable-threads</code></dt>
      <dd>禁用线程支持，如果不使用线程化的MPM ，可以关闭它以减少系统开销。</dd>
      <dt><code>--disable-lfs</code></dt>
      <dd>在32-bit平台上禁用大文件支持(large file support)</dd>
      <dt><code>--enable-threads</code></dt>
      <dd>启用线程支持，在线程型的MPM上必须打开它</dd>
      <dt><code>--disable-ipv6</code></dt>
      <dd>禁用IPv6支持</dd>
      <dt><code>--disable-dso</code></dt>
      <dd>禁用DSO支持</dd>
    </dl>

  <h3><a name="packages" id="packages">特殊程序包选项</a></h3>
    <p>这些指令用于定义特殊程序包相关的选项。</p>

      <dl>
        <dt><code>--with-included-apr</code></dt>
        <dd>在编译时强制使用当前源代码中绑定的APR版本，仅在2.2.3以后的版本中可用。</dd>

        <dt><code>--with-apr=<var>DIR</var>|<var>FILE</var></code></dt>
        <dd><a class="glossarylink" href="../glossary.html#apr" title="see glossary">Apache可移植运行时(APR)</a>是httpd源码的一部分并会自动与httpd一起创建。如果你想使用一个已经存在的APR ，就必须在这里指定<code>apr-config</code>脚本的路径。可以使用此脚本的绝对路径或已有的APR安装目录(<code>apr-config</code>必须位于此目录或者其下的"<code>bin</code>"子目录中)。</dd>

        <dt><code>--with-apr-util=<var>DIR</var>|<var>FILE</var></code></dt>
        <dd>Apache可移植运行时工具包(APU)是httpd源码的一部分并会自动与httpd一起创建。如果你想使用一个已经存在的APU ，就必须在这里指定<code>apu-config</code>脚本的路径。可以使用此脚本的绝对路径或已有的APU安装目录(<code>apu-config</code>必须位于此目录或者其下的"<code>bin</code>"子目录中)。</dd>

        <dt><code>--with-ssl=<var>DIR</var></code></dt>
        <dd>如果启用了<code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> ，<code>configure</code>脚本将会自动搜寻已经安装的OpenSSL ，你可以在这里指定OpenSSL SSL/TLS工具包的位置。</dd>

        <dt><code>--with-sslc=<var>DIR</var></code></dt>
        <dd>使用 RSA SSL-C SSL/TLS 工具包代替OpenSSL ，并指定 RSA SSL-C SSL/TLS 的位置。</dd>

        <dt><code>--with-z=<var>DIR</var></code></dt>
        <dd>如果你启用了压缩模块(比如<code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code>)，<code>configure</code>脚本将会自动搜寻已经安装的<code>zlib</code>库，你可以在这里指定它的安装路径。</dd>

        <dt><code>--with-perl=<var>DIR</var></code></dt>
        <dd>有些用Perl写的支持脚本，如<code class="program"><a href="apxs.html">apxs</a></code>或<code class="program"><a href="dbmmanage.html">dbmmanage</a></code> ，需要Perl5解释器(5.003或以上的版本就足够了)。如果系统中存在多个Perl解释器，比如有系统提供的Perl 4 ，还有你自己安装的Perl 5 ，推荐你使用该选项来指定正确的版本。如果没有Perl 5也没关系，这并不影响Apache httpd的编译和安装，只是相关的支持脚本不能使用而已。</dd>

        <dt><code>--with-pcre=<var>DIR</var></code></dt>
        <dd>5.0版的Perl兼容正则表达式库(PCRE)已经被包含进来了，如果你想使用系统中已经安装好的PCRE ，就可以在这里指定其安装路径。</dd>

		<dt><code>--with-ldap=<var>DIR</var></code></dt>
		<dd>一些Apache模块，比如<code class="module"><a href="../mod/mod_ldap.html">mod_ldap</a></code>和<code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code>需要APU支持LDAP(默认并不支持)，只要使用其中之一，就要使用该选项指定LDAP的安装路径。</dd>
      </dl>

      <p>一些Apache模块，比如<code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code>和<code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>需要使用DBM数据库，APU中已经包含了SDBM ，所以这个数据库总是可用的。如果你想使用其他类型的数据库，就要使用以下选项：</p>

      <dl>
        <dt><code>--with-gdbm[=<var>path</var>]</code></dt>
        <dd>使用GNU DBM代替SDBM；如果不指定<var>path</var> ，则<code>configure</code>脚本将会在默认路径上搜索GNU DBM的包含文件和库的位置。如果指定<var>path</var> ，则<code>configure</code>脚本会在<code><var>path</var>/lib</code>和<code><var>path</var>/include</code>目录中搜索GNU DBM的包含文件和库。还可以使用"<var>inc-path:lib-path</var>"的形式分别指定GNU DBM的包含文件和库的位置。</dd>

        <dt><code>--with-ndbm[=<var>path</var>]</code></dt>
        <dd>使用New DBM代替SDBM；如果不指定<var>path</var> ，则<code>configure</code>脚本将会在默认路径上搜索New DBM的包含文件和库的位置。如果指定<var>path</var> ，则<code>configure</code>脚本会在<code><var>path</var>/lib</code>和<code><var>path</var>/include</code>目录中搜索New DBM的包含文件和库。还可以使用"<var>inc-path:lib-path</var>"的形式分别指定New DBM的包含文件和库的位置。</dd>

        <dt><code>--with-berkeley-db[=<var>path</var>]</code></dt>
        <dd>使用Berkeley DB代替SDBM；如果不指定<var>path</var> ，则<code>configure</code>脚本将会在默认路径上搜索Berkeley DB的包含文件和库的位置。如果指定<var>path</var> ，则<code>configure</code>脚本会在<code><var>path</var>/lib</code>和<code><var>path</var>/include</code>目录中搜索Berkeley DB的包含文件和库。还可以使用"<var>inc-path:lib-path</var>"的形式分别指定Berkeley DB的包含文件和库的位置。</dd>
      </dl>

      <div class="note"><h3>注意</h3>
        <p>DBM数据库选项是由APU提供并传递给APU配置脚本的。所以如果使用 <code>--with-apr-util</code> 指定一个已安装的APU来代替，那么这些选项便无效。你可以同时使用几种不同的DBM实现，然后使用运行时配置动态选择其中之一。</p>
      </div>

  <h3><a name="supportopt" id="supportopt">支持程序选项</a></h3>
    <dl>
      <dt><code>--enable-static-support</code></dt>
      <dd>使用静态连接(默认为动态连接)编译所有二进制支持程序。若不使用该选项也可以使用下面的选项分别指定每个支持程序：</dd>
      <dt><code>--enable-static-ab</code></dt>
      <dd>使用静态连接编译<code class="program"><a href="ab.html">ab</a></code></dd>
      <dt><code>--enable-static-checkgid</code></dt>
      <dd>使用静态连接编译<code>checkgid</code></dd>
      <dt><code>--enable-static-htdbm</code></dt>
      <dd>使用静态连接编译<code class="program"><a href="htdbm.html">htdbm</a></code></dd>
      <dt><code>--enable-static-htdigest</code></dt>
      <dd>使用静态连接编译<code class="program"><a href="htdigest.html">htdigest</a></code></dd>
      <dt><code>--enable-static-htpasswd</code></dt>
      <dd>使用静态连接编译<code class="program"><a href="htpasswd.html">htpasswd</a></code></dd>
      <dt><code>--enable-static-logresolve</code></dt>
      <dd>使用静态连接编译<code class="program"><a href="logresolve.html">logresolve</a></code></dd>
      <dt><code>--enable-static-rotatelogs</code></dt>
      <dd>使用静态连接编译<code class="program"><a href="rotatelogs.html">rotatelogs</a></code></dd>
    </dl>

    <h4><a name="suexec" id="suexec">suexec配置选项</a></h4>
      <dl>
        <dt><code>--enable-suexec</code></dt>
        <dd>使用这个选项以启用<code class="program"><a href="suexec.html">suexec</a></code> ，它可以允许你为CGI程序指定uid和gid 。<strong>如果你不精通suexec的工作机制，请不要使用它！</strong></dd>
      </dl>
	  <p>仅在启用了上述选项的情况下，才可以使用以下选项微调<code class="program"><a href="suexec.html">suexec</a></code>的各种特性。方括号"[]"内是默认值。参见<a href="../suexec.html#install">配置和安装suEXEC</a>以获得更多信息。</p>
      <dl>
        <dt><code>--with-suexec-bin</code></dt>
        <dd><code class="program"><a href="suexec.html">suexec</a></code>二进制文件目录[<code>--sbindir</code>]</dd>
        <dt><code>--with-suexec-caller</code></dt>
        <dd>允许调用<code class="program"><a href="suexec.html">suexec</a></code>的用户，必须和运行<code class="program"><a href="httpd.html">httpd</a></code>子进程的用户相同。</dd>
        <dt><code>--with-suexec-docroot</code></dt>
        <dd>允许<code class="program"><a href="suexec.html">suexec</a></code>对其中的文件具有执行权限的根目录[<code>--datadir/htdocs</code>]</dd>
        <dt><code>--with-suexec-gidmin</code></dt>
        <dd>允许执行<code class="program"><a href="suexec.html">suexec</a></code>的最小GID[100]</dd>
        <dt><code>--with-suexec-logfile</code></dt>
        <dd><code class="program"><a href="suexec.html">suexec</a></code>日志文件名[默认文件名为：<code>suexec_log</code> ，位于<code>--logfiledir</code>目录下]</dd>
        <dt><code>--with-suexec-safepath</code></dt>
        <dd>对<code class="program"><a href="suexec.html">suexec</a></code>"安全"的<code>PATH</code>环境变量的值[<code>/usr/local/bin:/usr/bin:/bin</code>]</dd>
        <dt><code>--with-suexec-userdir</code></dt>
        <dd>用户主目录下允许<code class="program"><a href="suexec.html">suexec</a></code>对其中的文件具有执行权限的子目录，仅在将<code class="program"><a href="suexec.html">suexec</a></code>和<a href="../howto/public_html.html">用户网站目录</a>(由<code class="module"><a href="../mod/mod_userdir.html">mod_userdir</a></code>提供支持)一起使用的情况下才需要设置此选项。[<code>public_html</code>]</dd>
        <dt><code>--with-suexec-uidmin</code></dt>
        <dd>允许执行<code class="program"><a href="suexec.html">suexec</a></code>的最小UID[100]</dd>
        <dt><code>--with-suexec-umask</code></dt>
        <dd><code class="program"><a href="suexec.html">suexec</a></code>进程的<code>umask</code>[取决于系统的设定]</dd>
      </dl>

</div><div class="top"><a href="configure.html#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="env" id="env">环境变量</a></h2>
  <p>可以通过指定某些环境变量来修改<code>configure</code>脚本的默认选择，或者帮助<code>configure</code>脚本找到名字和/或位置不标准的库和程序。</p>


  <dl>
    <dt><code>CC</code></dt>
    <dd>C编译器</dd>

    <dt><code>CFLAGS</code></dt>
    <dd>C编译器的flags</dd>

    <dt><code>CPP</code></dt>
    <dd>C预处理程序</dd>

    <dt><code>CPPFLAGS</code></dt>
    <dd>C/C++预处理程序flags，比如使用"<code>-I<var>includedir</var></code>"指定一个非标准的头文件目录<var>includedir</var> 。</dd>

    <dt><code>LDFLAGS</code></dt>
    <dd>连接器flags，比如使用"-L<code>-L<var>libdir</var></code>"指定一个非标准的库文件目录<var>libdir</var> 。</dd>
  </dl>
</div></div>
<div id="footer">
<p class="apache">本文允许自由的转载、引用、再分发，但必须保留译者署名并注明出处；详见：<a href="../translator_announcement.html#announcement">版权声明</a>。</p>
<p class="menu"><a href="../mod/index.html">模块索引</a> | <a href="../mod/directives.html">指令索引</a> | <a href="../faq/index.html">常见问题</a> | <a href="../glossary.html">词汇表</a> | <a href="../sitemap.html">站点导航</a></p></div>
</body></html>
